GET Hero Ratings by Subject
/openmlbb/academy/heroes/ratings/{subject}
API Path: /api/academy/heroes/ratings/{subject}
Retrieve hero ratings for a specific subject from the ratings index. Supports query parameter for localization.
Path parameters:
- subject: Rating subject key from the ratings index response (7 characters).
Query parameters:
- lang: Language code for localized content (default:
en).
The response includes hero rating data for the chosen subject:
- list: Array of hero entries, each containing:
- object: Hero object ID.
- title: Hero name (e.g., 'Fanny').
- image: Hero image URL.
- image_big: Larger hero image URL.
- channel: Array of channel IDs.
- score: Hero score value (e.g., '8.8').
- score_total: Total score points accumulated.
- score_count: Number of votes.
- hot_comment: Highlighted community comment.
- hashtags: Optional hashtags associated with the poll.
This endpoint is useful for:
- Displaying detailed ratings within a chosen poll or theme.
- Allowing players to explore community sentiment.
- Surfacing popularity for heroes in specific categories (e.g., 'Top Jungler', 'Most Charismatic Hero').
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.academy.heroes_ratings_subject("all", lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| subject | path | string | yes | - |
| lang | query | string | no | en |